home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / bbsl0288.zip / SYSOP.DOC < prev   
Text File  |  1988-02-12  |  13KB  |  335 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                    SYSOP DOCUMENTATION FOR DOORS
  11.  
  12.                              for the
  13.  
  14.                       IBM Personal Computer
  15.  
  16.                           Version 02-88
  17.                            and higher
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                by
  24.  
  25.                        Bob Westcott
  26.                        7 Dunloggin Drive
  27.                        Merrimack N.H. 03054
  28.                        Voice (603) 424-6977
  29.                        Data  (603) 424-5497
  30.  
  31.                             Feb, 1988
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. Whats new in this version of Doorware:
  68.  
  69. No longer have to sign on the BBS first to go to local mode.
  70.  
  71. Should work with all versions of RBBS 15.1C and above.
  72. Should work with all versions of QuickBBS 2.0 and higher.
  73.  
  74.  
  75. 1.1 Introduction
  76. ----------------
  77. Doorware  is  the name I have given the type of software  that  I 
  78. make  to  operate  on the RBBS type of BBS.   I try to  make  the 
  79. software  as error free as possible but "Murphy" is always  there 
  80. so  if  you  run into errors please call via  voice  or  leave  a 
  81. message  on my BBS and I will try to have them fixed on the  next 
  82. version.
  83.  
  84. If  you have any software that you think will make a good door  I 
  85. am  always looking for that type to convert to  Doorware.  To  do 
  86. this  the  code  must be in basic SOURCE.  I do not  release  the 
  87. source code without the authors permission and then only the code 
  88. as  I receive it.  Credit for the software is ALWAYS given to the 
  89. author (if know).
  90.  
  91. Because  it  is very possible to cause a security problem on  the 
  92. RBBS  (people being able to get into your DOS) the door  part  of 
  93. the source will not be made available.  I will help anyone who is 
  94. interested in the way you write software to work on the 'Doors'. 
  95. Also  I have been writing code for over 15 years and the first 10 
  96. I  always release my source code,  but as it always went  someone 
  97. would change some code (Really trying to improve it) and blew  it 
  98. and since I always have my name,  address, and phone number on my 
  99. software  it always came back with with what a bad program it was 
  100. and  it  doesn't work correctlly and I got a bad name.  So  I  no 
  101. longer give out code. 
  102.  
  103. The software is able to handle multi-tasking under Multi-Link and 
  104. Double Dos, but is limited to 9 nodes.
  105.  
  106. 1.2 Update Conventions
  107. ----------------------
  108. Since new versions should no longer be necessary when when either 
  109. a  new  version of RBBS or QuickBBS the only updates will  be  to 
  110. make improvements and new software.
  111. The convention of showing versions shall be as follows:
  112. xxxxyyzz.ARC
  113. Where xxxx is the first 4 letters of the software.
  114. Where yy is the month of release.
  115. Where zz is the year of release.
  116.  
  117. The latest version of the Doorware will always be on my BBS  and 
  118. other selected BBS.
  119.  
  120. 2.1 Required files
  121. ------------------
  122. You must have a batch file that you are running your RBBS from. 
  123.  
  124. The purpose of the files are as follows:
  125.  1. filename.EXE    The operational software.
  126.  2. filename.DOC    The  file  which informs the player who what                      
  127.                     when and where about this program.
  128.  3. filename.SCR    This  is  the  daily score  board, but it is                    
  129.                     also    the    file    that    holds    your  
  130.                     system requirements.   Not all programs  use 
  131.                     the score part of this file
  132.  4. filename1.SCR   This is the monthly score board.  Not always 
  133.                     used but always created.
  134.  5. filename.BAT    The   batch   file  that  gets  you  to  the 
  135.                     doorware from the RBBS.
  136.                     DO NOT USE THE SAME FILENAME AS THE DOORWARE
  137.                     NAME. THIS WILL CAUSE A PROBLEM!!!
  138.  5. SYSOP.DOC       This file.
  139.  6. PRELOG.xxx      The  same as  on the RBBS it allows  you  to 
  140.                     place notices on the system.
  141.                     xxx= the  1st  three letter/numbers  of  the 
  142.                     program.
  143.  7.filenameG.DOR    This file is not required but will allow you 
  144.                     to make a graphic picture with sound.
  145.  
  146.  
  147.  
  148.  
  149. ********** NOTE **********
  150. If  you  are going to use this software with the Door monitor  do 
  151. NOT  use the batch files as stated in this record.  Use only  the 
  152. batch files as stated in the monitor SYSOP.DOC.
  153.  
  154. 2.0 Setup
  155. ---------
  156. Because this software reads information from the RBBS files it is 
  157. very important that the supplied files MUST be placed on the same 
  158. drive that the DORINFOx.DEF is located.
  159.  
  160. You  must make the changes you want on following  information  in 
  161. the 1st 8 fields of the filename.SCR file:
  162.  
  163.  1.  Field #1 The   number of times the  user may  sign  on  to      
  164.               filename each day. (This does NOT apply to SYSOP he 
  165.               may sign  on as many times as he wishes)
  166.  2.  Field #2 The foregound color.
  167.  3.  Field #3 The background color.
  168.  4.  Field #4 The border color.
  169.  5.  Field #5 The  number  of minutes a player is allowed without              
  170.               making a move.
  171.  6.  Field #6 The total number of minutes allowed on this door.
  172.  7.  Field #7 This  field  determines  if you are going to use a     
  173.               common file for all games or a single file for each 
  174.               game.
  175.               See ** for more info about this.
  176.  8.   Field  #8 This field determines if SYSOP score will be used 
  177.              and if there will be sound as follows.
  178.               0  Sysop's score posted, No sound. 
  179.               1  Sysop's score not posted, No sound. 
  180.               2  Sysop's score posted, With sound.
  181.               3  Sysop's score not posted, With sound.
  182.  
  183. **  This  field is used as follows if set to '0' it means a  file 
  184. called  filename.DAY will be created and will list all the  users 
  185. that  has signed on THAT day to THAT program and will be used  by 
  186. field  #1 to determine how many times a user has signed  on  THAT 
  187. day.
  188. If  this field is set to a '1' then a file called COMMON.DAY will 
  189. be created and will have all the users that have signed on to any 
  190. program that has this field set to '1' to be logged.
  191. Example:
  192. You are running 3 games, GAME1.EXE, GAME2.EXE, and GAME3.EXE.
  193. You  have field #6 set to '1' on all programs and field #1 set to 
  194. '2' in all programs. The user will only be able to sign on to any 
  195. of the games 2 times (total) each day.
  196. If all 3 programs have field #6 set to '0' then the user may sign 
  197. on to EACH program 2 times each day.
  198. Beware  this fields may be mixed and will act as listed  and  mix 
  199. things up quite well, SO keep it as simple as possible.
  200. Remember this feature will only be true if the door software  you 
  201. are  using will allow this,  all my software EXCEPT CHESSDOR will 
  202. have this feature.
  203.  
  204. The filename.SCR file will create itself if it can not find  one. 
  205. It will set the all starting scores to 0. If you wish to start at 
  206. any other score you can use EDLIN to change them, but remember to 
  207. change  them EACH month as they will be reset to 0 with the first 
  208. user each month.  DO NOT TRY TO CREATE THIS YOURSELF AS IT CAN BE 
  209. MESSED UP AND CAUSE ERRORS.
  210.  
  211. The  filename1.SCR file is very simple and will create itself  if 
  212. one can not be found.
  213. This files holds the monthly champ information,  but will NOT  be 
  214. outputed until the first monthly champ is created.
  215. The  last  entry of the filename.BAT is the file  that  the  RBBS 
  216. calls to bring up the door program. 
  217.  
  218. The following will work for both tasking and NON-tasking systems.
  219. -----------------------------------------------------------------
  220.  
  221.  (The filename.BAT file )
  222.  
  223.   WATCHDG1 OFF                       To allow around program to 
  224.                                      monitor line (a must!!)
  225.   filename %1                        Call the door program.
  226.  
  227. The door menu file must have the filename in capitals.
  228.  
  229.  
  230. Do  NOT remove the 'WATCHDGx ON' call from the RBBS.BAT files  as 
  231. they  are needed when you go to your DOS from remote (7 from  the 
  232. main menu).
  233.  
  234. You may now use the same door menu file for the nodes as RBBS now 
  235. passes the node information to the batch files.
  236.  
  237. QUICKBBS:
  238. Set up to have function 7 call:
  239. filename 1         ' for users
  240. filename           ' for local
  241.  
  242. 2.3 Running the Doorware program
  243. --------------------------------
  244. After  completing  the  setup as stated above  insure  that  when 
  245. running the CONFIG file for the RBBS that you have the doors open 
  246. and  allow  the correct access level users to use the doors  that 
  247. you want. Also insure that the RBBS answers on ring 1 or higher.
  248.  
  249. That  is all that is needed to make this work in remote.   To run 
  250. in  local just be on the drive where the program is  located  and 
  251. type the name of the program.
  252.  
  253. While  watching  the screen when a remote user is on a  door  you 
  254. will  see  the  users  name is in the lower left  corner  of  the 
  255. screen,  in  the  middle will be the version #  of  the  Doorware 
  256. program that you are using and the node that is operating, and on 
  257. the  right side you will have displayed the time the user started 
  258. using the the program when the program is first loaded (15:23:47) 
  259. then  it will display the number of minutes the user has left  in 
  260. the doors (M.L.= 23:42). Also when the remote users screen does a 
  261. clear  yours  will NOT it will just  print  (CLEAR  SCREEN).  The 
  262. purpose  of this is to keep the 25 line on your screen and  clear 
  263. to remote users screen.
  264.  
  265. The  following  two paragraphs are only true when using NO  multi 
  266. tasking or when using Double DOS.
  267.  
  268. Pressing  the  function  #10 key while a remote user  is  on  the 
  269. system will place you in the chat mode and allow you to talk with 
  270. the player.   To return the player to the game you must press the 
  271. ESC  key this is the same procedure as on the RBBS.   The  player 
  272. does NOT have a function on his menu to call you.
  273.  
  274. Pressing the function #8 key allows you to reduce or increase the 
  275. time the player is allowed to stay on on this one time.  You will 
  276. get a prompt for the number of minutes you wish to let them  have 
  277. then  you  enter  a number and press enter.   This will  cause  a 
  278. message  to be place on the screen to inform the player that  the 
  279. amount of around has changed.
  280.  
  281. So you got a problem!!!  
  282. -----------------------
  283. If you have a problem installing this program or it bombs on  you 
  284. look for the following data:
  285.  
  286. 1.  A printout displayed on your screen telling you the problem.
  287. 2.  Look  on  the disk that holds the main DOR program for a file    
  288. named  ERRORS.DOR  and print it.  This info should  be  forwarded    
  289. to me for debuging and correction.
  290.  
  291. In most cases (all I hope) one of the 2 above indications  should 
  292. happen  when a error occurs.  All errors should be reported to be 
  293. via phone or RBBS if possible for correction.
  294.  
  295. Good luck and enjoy this software.
  296.  
  297.                                  Bob...
  298.  
  299. Bob Westcott
  300. 7 Dunloggin Drive
  301. Merrimack N.H   03054
  302.  
  303. (D)ata  603-424-5497
  304. (V)oice 603-424-6977
  305.                                                                                               ill place you in the chat mode and allow you to talk with 
  306. the player.   To return the player to the game you must press the 
  307. ESC  key this is the same procedure as on the RBBS.   The  player 
  308. does NOT have a function on his menu to call you.
  309.  
  310. Pressing the function #8 key allows you to reduce or increase the 
  311. time the player is allowed to stay on on this one time.  You will 
  312. get a prompt for the number of minutes you wish to let them  have 
  313. then  you  enter  a number and press enter.   This will  cause  a 
  314. message  to be place on the screen to inform the player that  the 
  315. amount of around has changed.
  316.  
  317. So you got a problem!!!  
  318. -----------------------
  319. If you have a problem installing this program or it bombs on  you 
  320. look for the following data:
  321.  
  322. 1.  A printout displayed on your screen telling you the problem.
  323. 2.  Look  on  the disk that holds the main DOR program for a file    
  324. named  ERRORS.DOR  and print it.  This info should  be  forwarded    
  325. to me for debuging and correction.
  326.  
  327. In most cases (all I hope) one of the 2 above indications  should 
  328. happen  when a error occurs.  All errors should be reported to be 
  329. via phone or RBBS if possible for correction.
  330.  
  331. Good luck and enjoy this software.
  332.  
  333.                                  Bob...
  334.                                                                  
  335.